home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / gnu / dejagnu.lha / dejagnu-1.0.1 / tcl / doc / CrtInterp.3 < prev    next >
Text File  |  1993-02-14  |  2KB  |  49 lines
  1. '\"
  2. '\" Copyright 1989 Regents of the University of California
  3. '\" Permission to use, copy, modify, and distribute this
  4. '\" documentation for any purpose and without fee is hereby
  5. '\" granted, provided that this notice appears in all copies.
  6. '\" The University of California makes no representations about
  7. '\" the suitability of this material for any purpose.  It is
  8. '\" provided "as is" without express or implied warranty.
  9. '\" 
  10. .so man.macros
  11. .HS Tcl_CreateInterp tcl
  12. .BS
  13. .SH NAME
  14. Tcl_CreateInterp, Tcl_DeleteInterp \- create and delete Tcl command interpreters
  15. .SH SYNOPSIS
  16. .nf
  17. \fB#include <tcl.h>\fR
  18. .sp
  19. Tcl_Interp *
  20. \fBTcl_CreateInterp\fR()
  21. .sp
  22. \fBTcl_DeleteInterp\fR(\fIinterp\fR)
  23. .SH ARGUMENTS
  24. .AS Tcl_Interp *interp
  25. .AP Tcl_Interp *interp in
  26. Token for interpreter to be destroyed.
  27. .BE
  28.  
  29. .SH DESCRIPTION
  30. .PP
  31. \fBTcl_CreateInterp\fR creates a new interpreter structure and returns
  32. a token for it.  The token is required in calls to most other Tcl
  33. procedures, such as \fBTcl_CreateCommand\fR, \fBTcl_Eval\fR, and
  34. \fBTcl_DeleteInterp\fR.
  35. Clients are only allowed to access a few of the fields of
  36. Tcl_Interp structures;  see the Tcl_Interp
  37. and \fBTcl_CreateCommand\fR man pages for details.
  38. The new interpreter is initialized with no defined variables and only
  39. the built-in Tcl commands.  To bind in additional commands, call
  40. \fBTcl_CreateCommand\fR.
  41. .PP
  42. \fBTcl_DeleteInterp\fR destroys a command interpreter and releases all of
  43. the resources associated with it, including variables, procedures,
  44. and application-specific command bindings.  After \fBTcl_DeleteInterp\fR
  45. returns the caller should never again use the \fIinterp\fR token.
  46.  
  47. .SH KEYWORDS
  48. command, create, delete, interpreter
  49.